<?php

interface Whatsit_Database
{
    function __construct($username);

    /**
    * gets an array of whatsits for a particular user ane pane
    * @param string $user_id id of the user
    * @param string $pane_name the name of the pane.  could be "right" or "left" or "center" depending on your system's configuration
    * @returns an array of urls of whatsits in the pane from top to bottom in order
    */
    public function getWhatsits($pane_name);

    public function setPref($id, $pref_name, $pref_value);

    public function addWhatsit($url, $pane);

    public function moveWhatsit($whatsit_id, $from_pane, $to_pane, $after_whatsit_id);

    public function getWhatsit($id);
}
